使用 Kanzi Engine 插件

Kanzi Engine 插件扩展 Kanzi Engine 的功能。Kanzi Engine 在目标平台上执行这些插件。 使用 Kanzi Engine 插件：

• 使用 Kanzi Engine API 创建自定义节点，将其用于 Kanzi Studio 工程，并在 Kanzi Studio 预览 (Preview) 中查看其工作情况。
• 使用 Kanzi Engine API 创建自定义属性类型和消息，并将其用于 Kanzi Studio 工程。
• 定义您的 Kanzi 应用程序的数据录入点，并形成 Kanzi 应用程序设计师和开发者之间的约定。

要了解如何使用 Kanzi Engine 插件，请参阅：

• 扩展 Kanzi Engine 的功能
• 教程：从数据源获取应用程序数据
• Node2D 插件示例
• Node3D 插件示例

添加 Kanzi Engine 插件到 Kanzi Studio 工程中

要添加 Kanzi Engine 插件到 Kanzi Studio 工程中：

1. 在素材库 (Library) 中右键点击Kanzi Engine 插件 (Kanzi Engine Plugins) 并选择导入 Kanzi Engine 插件 (Import Kanzi Engine Plugin)。
   
   建议

   您可以使用脚本自动导入 Kanzi Engine 插件。请参阅使用脚本导入 Kanzi Engine 插件。

2. 选择您要导入的插件的 DLL 文件，然后点击打开 (Open)。
   您在素材库 (Library) > Kanzi Engine 插件 (Kanzi Engine Plugins) 中选择导入的插件时，可以在属性 (Properties) 中看到插件引入 Kanzi Studio 工程的内容列表。例如，在属性 (Properties) 中您可以看到选定插件提供的属性类型、组件、数据源、渲染通道、节点组件和触发器动作类型。

3. 确保在 Visual Studio 中构建应用程序和插件工程使用的解决方案配置与 Kanzi Studio 工程的设置相匹配。
   例如，如果您在 Visual Studio 中使用 GL_vs2015_Release 解决方案配置，则在 Kanzi Studio 工程的 工程 (Project) > 属性 (Properties) 中设置：

   • 预览 OpenGL ES 包装 (Preview OpenGL ES Wrapper) 为GL （通过桌面 OpenGL GL 仿真）(Emulation through desktop OpenGL)
   • 预览版本配置 (Preview Build Configuration) 为释放 (Release)
   • 预览 Visual Studio 版本 (Preview Visual Studio Version) 为2015
   • 预览工作目录 (Preview Working Directory) 为..\Application\bin。

   通过这些设置，将 Kanzi Studio 预览 (Preview) 设为与插件配合使用。
   

4. 在素材库 (Library) > Kanzi Engine 插件 (Kanzi Engine Plugins) 中选择插件，并确保在属性 (Properties) 中启用已启用 (Is Enabled) 属性。
   
   建议

   使用 已启用 (Is Enabled) 属性启用或禁用工程中的任何 Kanzi Engine 插件。

5. 按下 Ctrl F8 或选择预览 (Preview) > 重启预览 (Restart Preview) 重启预览 (Preview)。
   您现在可以使用 Kanzi Studio 工程中的插件提供的内容。

更新工程中的 Kanzi Engine 插件

您想使用您在 Kanzi Studio 工程中使用的新版本 Kanzi Engine 插件时，您必须更新 Kanzi Studio工程中的 Kanzi Engine 插件。

要更新 Kanzi Studio 工程中的 Kanzi Engine 插件：

1. 将插件的 .dll 文件复制到插件先前版本所在的位置。
   
2. 按以下方式之一更新 Kanzi Engine 插件：
   • 要更新特定 Kanzi Engine 插件，在素材库 (Library) > Kanzi Engine 插件 (Kanzi Engine Plugins) 中右键点击该插件并选择更新 Kanzi Engine 插件 (Update Kanzi Engine Plugin)。
     Kanzi Studio 加载插件的新版本时，会显示插件中定义的属性和类的更改。
     
   • 要更新工程或解决方案中的所有插件，在素材库 (Library) 中右键点击 Kanzi Engine 插件 (Kanzi Engine Plugins) 并选择以下任一项：
     • 更新工程中的 Kanzi Engine 插件 (Update Kanzi Engine Plugins in Project) 以更新 Kanzi Studio 工程中的插件
     • 更新解决方案中的 Kanzi Engine 插件 (Update Kanzi Engine Plugins in Solution) 以更新 Kanzi Studio 工程或引用工程中的插件
       
     Kanzi Studio 加载插件的新版本时，它向日志 (Log) 窗口打印插件中定义的属性和类的更改。
     
   • 要使用脚本更新 Kanzi Engine 插件，请参阅 使用脚本更新 Kanzi Engine 插件 和 使用脚本更新工程或解决方案中的所有 Kanzi Engine 插件。

移除工程中的 Kanzi Engine 插件

移除 Kanzi Studio 工程中的 Kanzi Engine 插件时，Kanzi Studio 会移除对 Kanzi Engine 插件的引用，但不会删除您所移除的 Kanzi Engine 插件的 .dll 文件。

要移除 Kanzi Studio 工程中的 Kanzi Engine 插件，请在素材库 (Library) > Kanzi Engine 插件 (Kanzi Engine Plugins) 中右键点击您要移除的插件，然后选择 Delete。

另请参阅

创建 Kanzi Engine 插件

Kanzi Engine 插件

使用脚本导入和更新 Kanzi Engine 插件

打开导航